Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Reporting Information to the User

GXGetPrintingAlert

You can use the GXGetPrintingAlert function to display a printing alert box defined by a printing alert resource.

OSErr GXGetPrintingAlert (short alertResId,
                  ModalFilterProcPtr filterProc, short *itemHit);

alertResId

The ID of the printing alert ('plrt') resource that defines the contents of the alert box.

filterProc

A pointer to the function to use for filtering events that occur while the alert box is displayed.

itemHit

A pointer to the ID of the item that the user selected to dismiss the alert box.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXGetPrintingAlert function displays a printing alert box. The contents of the alert box are defined in the printing alert resource that has the ID specified in the alertResId parameter.

User-initiated events that occur while the alert box is displayed are filtered through the function that is specified by the filterProc parameter. When the user dismisses the printing alert box by selecting an item, this function returns in the itemHit parameter the ID of the item that was selected.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The printing alert resource is described in the section "The Printing Alert ('plrt') Resource" beginning on page 6-21 in the chapter "Printing Resources".

You can use the GXPrintingAlert function, as described in the next section, to display a printing alert box whose contents are defined as parameters to the function.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help